home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 2 / The Arsenal Files 2 (Arsenal Computer).ISO / lan / aiodig.exe / AIODIG.TXT < prev   
Text File  |  1994-06-07  |  19KB  |  460 lines
  1.  
  2.               NOVELL TECHNICAL INFORMATION DOCUMENT
  3.  
  4. TITLE:              Certified DigiBoard DigiCHANNEL PC/Xem Board Drivers
  5. DOCUMENT ID:        TID250169
  6. DOCUMENT REVISION:  A
  7. DATE:               06JUN94
  8. ALERT STATUS:       Yellow
  9. INFORMATION TYPE:   Symptom Solution
  10. README FOR:         AIODIG.EXE
  11.  
  12. NOVELL PRODUCT and VERSION:
  13. NetWare Connect 1.0
  14.  
  15. ABSTRACT:
  16.  
  17. Certified NetWare Connect drivers for DigiBoard DigiCHANNEL PC/Xem Boards.
  18.  
  19. ------------------------------------------------------------------------------
  20. DISCLAIMER
  21. THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL.  NOVELL
  22. MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION.  HOWEVER, THE
  23. INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY.  NOVELL
  24. MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION.
  25. ------------------------------------------------------------------------------
  26.  
  27. ADDITIONAL CONFIGURATION
  28.  
  29. Third-Party Product and Version:
  30.  
  31. DigiBoard DigiCHANNEL PC/Xem Boards
  32.  
  33. SYMPTOM
  34.  
  35. Problems occur using DigiBoard DigiCHANNEL PC/Xem Board with NetWare Connect.
  36.  
  37. SOLUTION
  38.  
  39. Apply the files in AIODGI.EXE following these instructions.
  40.  
  41. Self-Extracting File Name:  AIODGI.EXE
  42.  
  43. Files Included     Size     Date
  44.  
  45. AIODGI.TXT      ( This File )
  46. AIODGMEM.NLM   1516 4-11-94
  47. AIODGXEM.NLM   90560     4-11-94
  48.  
  49. Installation Instructions:
  50.  
  51. 1. These drivers are supplied by DigiBoard.  If you need technical support
  52. relative to a Digiboard, board or driver, call DigiBoard at 612-943-9020
  53.  
  54. 2. Copy AIODGXEM.NLM and AIODGMEM.NLM to SYS:SYSTEM
  55.  
  56. 3. Loading the Driver
  57.  
  58.    The user supplies information to the driver through a set of command line
  59. parameters at load time.  Some or all of the parameters are optional,
  60. depending on the type of board you are using.  On ISA and EISA bus servers,
  61. the driver must be loaded for each board.  On MCA bus servers, the driver may
  62. be loaded for each board individually or it may be loaded once to support all
  63. boards in the server.  The load command has the following general format :
  64.  
  65.      load 'drivername' { necessary and optional parameters }
  66.  
  67. The specific format depends on the type of PC/Xem and/or the bus type of the
  68. computer.
  69.  
  70. The command line syntax for the driver supporting these boards on ISA, EISA
  71. and MCA machines is shown below. Parameters specified in brackets ( [] ) are
  72. optional.
  73.  
  74. ISA boards in ISA machines :
  75.      load aiodgxem port=xxx mem=xxxxx [name=bname] [node=0] [altp[=mask]]
  76.  
  77. ISA boards in EISA machines :
  78.      load aiodgxem slot=x port=xxx mem=xxxxx [name=bname] [node=0]
  79. [altp[=mask]]
  80.  
  81. EISA boards in EISA machines :
  82.      load aiodgxem slot=x mem=xxxxx [name=bname] [node=0] [altp[=mask]]
  83.  
  84. MCA boards :
  85.      load aiodgxi [port=xxxx mem=xxxxx [name=bname]] [node=0]
  86. altp[=mask[,mask[,mask[,mask]]]]]
  87.  
  88. When the 'port=' and 'mem=' parameters are not used, the driver will load
  89. support for all boards found in the system at supported memory addresses.
  90.  
  91. A description of the parameters follows.
  92. port=xxx
  93. This parameter is the board's 3 digit hex I/O port address.
  94.      For example: port=324.
  95.  
  96. When used with MCA boards, the 'mem=' parameter must also be used.
  97.      
  98. slot=x
  99. This parameter is the board's EISA slot number.
  100.      For example: slot=3.
  101.  
  102. mem=xxxxx :
  103. This parameter is the 5 digit hex starting address of the board's dual-ported
  104. memory.
  105.  
  106.      For example: mem=d0000.
  107.  
  108. When used with MCA boards, the 'port=' parameter must also be used.
  109.  
  110. name=bname :
  111. This parameter is optional and permits specification of a 10 character name to
  112. identify the board.  bname may consist of any combination of alphanumerical
  113. characters.  If no name is specified, one will be assigned by the driver.
  114. Following is a list of the board's I/O port addresses or slot number and the
  115. associated default names and board numbers.
  116.  
  117.           For boards in ISA machines :
  118.       Port         Default     Board
  119.           Address      Name        Number
  120.           -------      --------    ------
  121.           104h         DigiXem00     0
  122.           114h         DigiXem01     1
  123.           124h         DigiXem02     2
  124.           204h         DigiXem03     3
  125.           224h         DigiXem04     4
  126.           304h         DigiXem05     5
  127.                324h         DigiXem06     6
  128.  
  129.           For boards in EISA machines :
  130.           Slot         Default     Board
  131.           Number       Name        Number
  132.           -------      --------    ------
  133.             1          DigiXem00     0
  134.             2          DigiXem01     1
  135.             3          DigiXem02     2
  136.             4          DigiXem03     3
  137.                5          DigiXem04     4
  138.                  6          DigiXem05     5
  139.                  7          DigiXem06     6
  140.               8          DigiXem07     7
  141.  
  142.           For MCA boards :
  143.           Port         Default     Board
  144.           Address      Name        Number
  145.           -------      --------    ------
  146.           108h         DigiXem00     0
  147.              118h         DigiXem01     1
  148.           128h         DigiXem02     2
  149.           208h         DigiXem03     3
  150.           228h         DigiXem04     4
  151.           308h         DigiXem05     5
  152.           328h         DigiXem06     6
  153.  
  154. node=0 :
  155. This parameter must be used if you are using AIO.NLM version 1.0.2 or earlier.
  156. These versions of AIO need sequential board numbers based on the load order of
  157. the driver. (The first board loaded will be assigned #0, the second board will
  158. be assigned #1 and so on.) Using the node=0 parameter informs the driver to
  159. assign board numbers sequentially starting at 0.  If this parameter is
  160. excluded, the driver will assign board numbers based on the I/O port address
  161. as defined above. The parameter is effective only when used on the first
  162. driver load and sets the method by which subsequently loaded boards will be
  163. numbered.
  164. altp[=mask]:
  165. The standard wiring for the RS-232 RJ-45 connectors found on the Xem modules
  166. places the modem control lines RI (Ring Indicator) and DCD (Data Carrier
  167. Detect) on pins 1 and 10, respectively, which makes them inaccessible to an
  168. 8-pin RJ-45 plug.  While RI is seldom used, DCD is necessary for most modem
  169. applications.
  170. To facilitate the use of 8-pin RJ-45 plugs, a software feature called "ALTPIN"
  171. is supported in this device driver.  When ALTPIN is active, DCD is swapped
  172. with DSR (Data Set Ready), which is on pin 1 of an 8-pin RJ-45 plug. To take
  173. advantage of this option, the cabling must route the DCD line to pin 1.
  174.  
  175. This parameter is optional and allows you to specify that you want to activate
  176. the driver's ALTPIN option. When this parameter is entered as just "altp", all
  177. ports on the board will operate with the ALTPIN option active. When entered as
  178. "altp=mask" the driver uses the hex mask to determine which ports will use the
  179. ALTPIN feature.
  180.  
  181.                          For example : altp=f0
  182.  
  183.                F0 (hex) = 11110000 (binary)
  184.                              ||||||||
  185.                                  |||||||+----Port 1
  186.                                  ||||||+-----Port 2
  187.                                  |||||+------Port 3
  188.                                  ||||+-------Port 4
  189.                                  |||+--------Port 5
  190.                                  ||+---------Port 6
  191.                                  |+----------Port 7
  192.                                  +-----------Port 8
  193.  
  194.                     This will activate ALTPIN on ports 5-8.
  195.  
  196. The mask can be up to 16 hex digits long to activate ALTPIN on up to 64 ports.
  197.  
  198.          altp[=mask[,mask[,mask[,mask]]]]] :
  199.  
  200. When autoloading support for all boards in a MCA server, four masks may be
  201. specified, one for each possible board.
  202.  
  203.      For example:
  204.           altp=1,8,10,80
  205.  
  206.            1 (hex) = 00000001 (binary)
  207.            8 (hex) = 00001000 (binary)
  208.           10 (hex) = 00010000 (binary)
  209.           80 (hex) = 10000000 (binary)
  210.                       ||||||||
  211.                       |||||||+----Port 1
  212.                       ||||||+-----Port 2
  213.                       |||||+------Port 3
  214.                       ||||+-------Port 4
  215.                       |||+--------Port 5
  216.                       ||+---------Port 6
  217.                       |+----------Port 7
  218.                       +-----------Port 8
  219.  
  220. In this example the first port on the first board, the fourth port on the
  221. second board, the fifth port on the third board and the eighth port on the
  222. fourth board will use ALTPIN.  When autoloading, the driver uses the MCA bus's
  223. POS (Programmable Option Select) capabilities to determine the MC/Xi boards
  224. that are installed in your server, starting with slot 1.  The first ALTPIN
  225. mask will activate ALTPIN on the board in the lowest numbered slot, the second
  226. mask for the next lowest slot, and so on.
  227.  
  228. IMPORTANT!  IRQs on MC PC/Xem must be set to 'Disabled' using the POS
  229. configuration utility found on the reference diskette.
  230.  
  231. Patch History:
  232.  
  233. This is the first time the drivers for the Xem boards have been placed in the
  234. NetWire Library.
  235.  
  236. FURTHER NOTES PROVIDED BY DigiBoard
  237. 1. Overview
  238. DigiBoard's support for Novell compatible asynchronous applications is
  239. provided through a universal driver conforming to the "AIO" (Asynchronous
  240. Input/Output) specification.  Use the AIO driver when DigiBoard hardware is
  241. being installed in the file server (or machine with runtime NetWare).  When
  242. DigiBoard hardware is installed in a machine other than the server (for
  243. instance NetWare Access Server v1.2) use the specific driver for that
  244. application.  AIO drivers are loaded on the file server from the system
  245. console (or RCONSOLE) command line or the AUTOEXEC.NCF file.  Installation is
  246. simply a matter of copying of the driver files AIODGXEM.NLM and AIODGMEM.NLM.
  247.  
  248. 2.  Supported Boards
  249. The DigiBoard AIO driver supports up to eight EISA boards, seven ISA boards or
  250. four MCA boards, each supporting up to 4 EBI modules for a maximal driver
  251. configuration of 512 ports.
  252.  
  253. 3.  Unsupported Hardware Features
  254. The driver does not use interrupts from the DigiChannel PC/Xem.  When
  255. configuring the MCA Xem using the POS configuration utility the board's
  256. 'Interrupt Vector' should be set to 'disabled'.  Although the driver supports
  257. the 8emp module the 9th port, the parallel port, is not usable by AIO.  This
  258. port is reported by the driver as a usable AIO port but it is really an
  259. unusable parallel port.
  260.  
  261. 4.  Error Messages
  262. The following error messages may occur while the driver is parsing the
  263. parameters.
  264.  
  265. *Usage Error: AIODGXEM port=xxx mem=xxxx [name=bname] [node=0].
  266. *Usage Error: AIODGXEM slot=x [port=xxx] mem=xxxx [name=bname] [node=0].
  267. These errors will appear if you load the driver with no parameters on ISA and
  268. EISA bus servers, respectively.
  269.  
  270. *Usage Error: First parameter not 'port='.
  271. The driver expects the first parameter to be port=xxx on ISA machines, but
  272. this was not the case.
  273.  
  274. *Usage Error: First parameter not 'slot='
  275. The driver expects the first parameter to be slot=x on EISA machines, but this
  276. was not the case.
  277. *Error: Invalid Port Address 0x310.
  278. This message indicates that an invalid port address was specified.
  279.  
  280. *Error: Port Address 0x310 is already supported.
  281. This message indicates that the driver is already supporting a DigiCHANNEL
  282. board at this port address.
  283.  
  284. *Error: Invalid Slot 10
  285. This message indicates that an invalid slot number was specified while loading
  286. the driver on a EISA computer (slots 1-8 are valid).
  287.  
  288. *Error: Slot 2 is already supported.
  289. This  message indicates that the driver is already supporting a DigiCHANNEL
  290. board in this slot on an EISA computer.
  291.  
  292. *Usage Error: Second parameter not 'mem='
  293. The driver expects the second parameter to be mem=xxxxx in ISA machines, but
  294. this was not the case.  The driver also expects this to be the second
  295. parameter in EISA machines if the 'port=' parameter was not the second
  296. parameter (when using an EISA board).
  297.  
  298. *Usage Error: Third parameter not 'mem='
  299. The driver expects the third parameter to be mem=xxxxx in EISA machines if
  300. 'port=' was the second parameter (specified for ISA boards), but this was not
  301. the case.
  302.  
  303. *Error: Invalid Memory Address 0xF0000.
  304. This message indicates that an invalid memory address was specified.
  305.  
  306. *Error: Memory Address 0xC0000 is already supported.
  307. This message indicates that the driver is already supporting a DigiCHANNEL
  308. board at the specified memory address.  This message will only be seen on MCA
  309. bus servers since boards cannot be 'stacked' at the same memory addresses in
  310. these machines.
  311.  
  312. *Error : Failed POS Hardware Registration.
  313. This message indicates that the MCA POS register registration was not accepted
  314. by Netware.
  315.  
  316. *Error: AllocateResourceTag failed.
  317. This message indicates that the driver could not allocate resources from
  318. Netware. Unload unnecessary NLM's and reload the driver.
  319.  
  320. *Error: AIORegisterDriver failed.
  321. This message indicates that Netware failed to permit registration of the
  322. driver.
  323.  
  324. *Error: AllocateSemiPermMemory returns NULL.
  325. This message indicates that the drivers request to allocate memory failed. 
  326. Unload unnecessary NLM's and reload the driver.
  327.  
  328. No usable boards found. / Installed boards already supported.
  329. This message appears only on MCA servers and indicates that no boards were
  330. found when POS was checked, or that the driver is already supporting the
  331. board(s) that were found.
  332.  
  333. The following error messages may occur while the driver is performing some
  334. initial tests on the DigiCHANNEL board.
  335.  
  336. Board 4: Port 310 Mem D0000 Failed Hardware Registration.
  337. This message indicates that Netware failed to accept the driver's attempt to
  338. register the board's hardware resources.
  339.  
  340. Board 4: Port 310 Mem D0000 Port 310 not found.
  341. This message indicates that the driver could not find a board with port 310h. 
  342. Check to insure that you have specified the correct I/O port or that you have
  343. properly configured the board's port address.
  344.  
  345. Board 4: Port 310 Mem D0000 Hardware Reset Fails.
  346. This message indicates that the driver could not place the board into a reset
  347. state.  This is most likely the result of an I/O port address conflict or a
  348. faulty board. Be sure that there are no other I/O ports in your system at the
  349. indicated I/O port address.
  350.  
  351. Board 4: Port 310 Mem D0000 Memory not found error x.
  352. This message indicates that the driver could not find the board's memory.  x
  353. indicates the number of memory errors found in a 256 byte block.
  354.  
  355. Board 4: Port 310 Mem D0000 Memory error x.
  356. This message indicates that the driver has found the board's memory, but it
  357. appears to be faulty.  x indicates the number of errors found in a 256 byte
  358. block.
  359.  
  360. Board 4: Port 310 Mem D0000 Memory fails disable.
  361. This message indicates that the board's memory could not be disabled. This
  362. could be the result of a memory overlap with some other memory in the system,
  363. or a faulty board.  Ensure that no memory conflict exists.
  364.  
  365. The following messages may occur during the drivers attempt to initialize the
  366. board.
  367.  
  368. Board 4: Port 310 Mem D0000 BIOS fails initialization.
  369. This message indicates that the board's on-board BIOS did not initialize
  370. properly.
  371.  
  372. Board 4: Port 310 Mem D0000 FEPOS Fails Initialization.
  373. This message indicates that the on-board operating system did not initialize
  374. successfully.
  375.  
  376. Board 4: Port 310 Mem D0000 FEPOS finds 0 ports.
  377. This message indicates that the on-board operating system initialized
  378. successfully but found no ports.  Check to see that the Xem modules are
  379. connected to the host adapter card.
  380.  
  381. Board 4: Port 310 Mem D0000 Command failure during Initialization.
  382. This message indicates that the on-board operating system encountered a
  383. failure during initialization of the asynchronous channels.
  384.  
  385. Limitations
  386. - The 8emp module (8 serial ports plus one parallel port) is viewed by the
  387. driver (and reported to AIO) as 9 serial ports.  However, the 9th port is
  388. actually the parallel port and is unusable as a serial port.  This means that
  389. of the 9 ports reported to AIO only the first 8 are usable.  There is no
  390. support under AIO for parallel ports.
  391.  
  392. - The AIO driver supports up to 4 host adapters for a maximal configuration of
  393. 256 ports.
  394.  
  395. - In ISA and EISA computers these boards may be configured to reside on 32k
  396. boundaries in the host memory address range from 80000h - EFFFFh.
  397.  
  398. - In MCA computers these boards may be configured to reside on 32k boundaries
  399. in the host memory address range from C0000h - DFFFFh.
  400.  
  401. - The following baud rates are not supported : 2000, 3600 and 7200 baud.
  402.  
  403. - Mark and Space Parity are not supported.
  404.  
  405. - The Deadman Timer function is not supported.
  406.  
  407. - Adjustable buffer sizes are not supported.
  408.  
  409. - While hardware handshaking is active, RTS can not be overridden.
  410.  
  411. 3. Bug Fix
  412. A delay was removed from the flush buffers routine.  This could cause errors
  413. in file transfers under heavy usage.
  414.  
  415. DigiBoard
  416. 6400 Flying Cloud Drive
  417. Eden Prairie, MN 55344
  418.  
  419. DigiBoard, DigiCHANNEL, PC/Xem is a trademark of DigiBoard.  NetWare, NetWare
  420. Access and Novell are registered trademarks of Novell, Incorporated.  All
  421. other brand and product names are the trademarks of their respective holders.
  422.  
  423. Copyright (c) Digi International, Inc 1994
  424. All Rights Reserved
  425.  
  426. Information in this document is subject to change without notice and does not
  427. represent a commitment on the part of DigiBoard.
  428.  
  429. DigiBoard provides this document "as is", without warranty of any kind, either
  430. expressed or implied, including, but not limited to, the particular purpose. 
  431. DigiBoard may make improvements and/or changes in this manual or in the
  432. product(s) and/or the program(s) described in this manual at any time.
  433.  
  434. This product could include technical inaccuracies or typographical errors. 
  435. Changes are periodically made to the information herein; these changes may be
  436. incorporated in new editions of the publication.
  437.  
  438. RESTRICTED RIGHTS:
  439. For non-U. S. Government use:
  440. These programs are supplied under a license.  They may be used, disclosed,
  441. and/or copied only as permitted under such license agreement.  Any copy must
  442. contain the above copyright notice and this restricted rights notice.  Use,
  443. copying, and/or disclosure of the programs is strictly prohibited unless
  444. otherwise provided in the license agreement.
  445.  
  446. For U.S. Government use:
  447. Use, duplication, or disclosure by the Government is subject to restrictions
  448. as set forth in sub-paragraph (c)(1)(ii) of the Rights in Technical Data and
  449. Computer Software clause of DFARS 52.227-7013.
  450.  
  451. ----------------------------------------------------------------
  452. Any trademarks referenced in this document are the property of their
  453. respective owners.  Consult your product manuals for complete trademark
  454. information.
  455. ----------------------------------------------------------------
  456.  
  457.  
  458.  
  459.  
  460.